IMsgServiceAdmin
: IUnknown
The
IMsgServiceAdmin interface is used to make changes to a message service
within a profile.
Quick Info
|
Header
file: |
MAPIX.H |
|
Exposed by: |
Message
service administration objects |
|
Implemented
by: |
MAPI |
|
Called by: |
Client
applications |
|
Corresponding
pointer type: |
LPSERVICEADMIN |
Vtable Order
|
GetLastError |
Returns a MAPIERROR
structure containing information about the last error that occurred for a
message service administration object. |
|
GetMsgServiceTable |
Provides
access to the message service s provider table, a listing of the message
services in the profile. |
|
CreateMsgService |
Adds a
message service to the current profile. |
|
DeleteMsgService |
Deletes a
message service from a profile. |
|
CopyMsgService |
Copies a
message service into a profile. |
|
RenameMsgService |
Assigns a
new name to a message service. |
|
ConfigureMsgService |
Enables a
user to reconfigure a message service using the service s configuration
property sheet. |
|
OpenProfileSection |
Opens a
section of the current profile and returns an IProfSect pointer for
further access |
|
MsgServiceTransportOrder |
Sets the
order in which transport providers are called to deliver a message. |
|
AdminProviders |
Returns a
pointer providing access to a provider administration object. |
|
SetPrimaryIdentity |
Designates
a message service to be the supplier of the primary identifier for the
profile. |
|
GetProviderTable |
Provides
access to the provider table, a listing of the service providers in the
profile. |
Remarks
An
implementation can get a pointer to an IMsgServiceAdmin interface in two
ways: by calling the IMAPISession::AdminServices method or by calling the IProfAdmin::AdminServices method. For clients
primarily concerned with profile configuration for example, control panels IProfAdmin::AdminServices
is the preferred way to get the IMsgServiceAdmin interface because it
does not log providers on to the MAPI session. If a client requires the ability
to make changes to the active profile, then IMAPISession::AdminServices
should be called to get the IMsgServiceAdmin pointer. Clients that are
modifying the profile that is active for the session should be designed with
the awareness that although MAPI does not allow a profile that is in use to be
deleted, there are no safeguards to prevent a client from removing all the
message services within the profile.